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Framework for network-executable test cases on eBusiness Services 

1. Describe your invention, stating the problem solved (if appropriate), and indicating the advantages of 
using the invention. 

This invention disclosure pertains to Service Oriented Architectures (SOA), and in particular, the use of 
Executable test cases to establish compatibility of an eBusiness Service to a category and to allow the 
generation of real-time Quality of Service data about the eBusiness Service. 

We begin by providing background information on Service Oriented Architectures and the world of 
eBusiness services. Given this background, we then discuss the invention: Executable test cases on 
eBusiness Services. 

Background 

SOA 

We believe we have isolated the necessary ingredients to make this world of eBusiness services a reality. 
It boils down to some fundamentally simple abstractions: 

1. Regard all network available functionality as an eBusiness service, encapsulate this behavior and 
define an API to it 

• Create eBusiness services by wrappering existing I/T application components or scripting 
together other eBusiness services in a workflow-style composition 

2. Describe the service using a ubiquitous, open standard, XML meta-data description format (Well 
Defined Services or WDS) 

• Describe the eBusiness service's API and location and categorize the "kind" or category of 
service it is 

• Describe the prerequisites to service access (authentication, billing, etc.) 

• Describe other aspects of the service (privacy policy, quality of service guarantees, etc.) 

3. Services are accessed based on an open standards-based protocol (eBusiness Services Protocol, 
eSP) layered on http and XML messaging. This protocol supports dynamic discovery of eBusiness 
services, negotiation of the prerequisites to access and invocation of the eBusiness services' API. 

The architectural relationships between the network entities in SOA are quite simple: 

1 . There are three roles a network component can play: service provider, service requestor, service 
broker 

2. There are three operations: publish, find and bind. 

3. The three operations involve WDS documents and are based on the eSP. 

The following diagram illustrates the 3 roles, 3 operations in a SOA architecture: 
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1. A service provider publishes a WDS document describing its eBusiness service to one or more 
service brokers. 

2. A service requestor (e.g. another eBusiness service that requires a particular kind of service) 
invokes the find operation on a service broker to discover which services are available matching 
requirements stated in a WDS template. The result of the find operation is a WDS document for each 
eBusiness service that met the criteria posed in the find operation. 

3. The service requestor negotiates access to the eBusiness service with the service provider and 
binds to (invokes) the service. 

World of eBusiness Services 

The result of this paradigm shift to eBusiness services will be a world in which the World Wide Web 
contains thousands and thousands of eBusiness services. Applications will be built by composing 
existing eBusiness services to produce higher-level eBusiness services. 

Innovation, in terms of technical and business models, using eBusiness services composition will be 
faster and cheaper than building new applications and business processes from scratch. This is 
particularly true if the business model requires intimate integration with suppliers or customers. Speed in 
innovation in the new economy is critical. Speed to innovation on the web is critical. New business 
models build fortunes. The new economy rewards first mover. Quicker a business can react to newly 
available eBusiness services, the quicker they can react to competitive opportunities/threats, the more 
successful they will be in the Internet economy. 

eBusiness Services value proposition 

In summary, the value proposition of eBusiness Services to a business is that the approach: 

• Maximizes reach to customers, 

• Increases choice of suppliers/partners, 

• Increases flexibility of business processes, 

• and increases speed of execution 

• while minimizing development and deployment cost and time to market for new eBusiness 
functionality. 

This yields a single technical strategy: start with existing eBusiness applications, decouple, encapsulate, 
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then reintegrate them into eBusiness Services. This provides the necessary flexibility and adaptability of 
eBusiness Systems to compete in emerging eMarketpIaces. 

Executable Test Cases 

The problems addressed by executable test cases: 

a) How can a service broker or taxonomy server determine that a candidate service is in fact 
appropriate for a given category? 

b) How can a service requestor (in collaboration with other services such as a services crawler) get reliable 
quality of service information about a service? 

2. How does the invention solve the problem or achieve an advantage,(a description of "the invention", 
including figures inline as appropriate)? 

We use executable test cases, associated with the canonical service description to address the problems 
outlined in the previous section. 

Canonical Service Descriptions are service descriptions that define a taxonomic category. Thus the 
executable tests for membership in the category, i.e., a test for each "method" in the service, are run 
against any service proposed as a candidate for a given category. It should be noted that services could 
spoof the test by ensuring that the canonical tests work. Running the tests is simply a mechanism for 
doing a first cut automated membership test. Social and legal constraints will also evolve to discourage 
spoofing. And, sophisticated tests will be run by crawlers that will be more difficult to spoof. Services 
crawlers are discussed in more detail in another disclosure. 

The canonical service description for each category must include a set of executable tests, described in 
XML, by which it can be objectively and automatically determined that a service satisfies the 
requirements for being included in that category. Security constraints on some services may require that 
the taxonomy server (an optional component of a service broker responsible for maintaining a taxonomy 
of eBusiness services) be given special certificates or other authentication information as a part of 
registration so that it can execute the tests. In situations that call for extreme security, authentication, or 
encryption, the taxonomy server may only receive exceptions in response to the tests. Even in that case, 
though, it should receive the correct exceptions, i.e., the exception received should indicate that the 
service is present but not responding due to inadequate authentication. The conflict between testability 
and security is not likely to be severe with general-purpose taxonomy servers. Highly secure services are 
likely to be registered with special purpose taxonomy servers that themselves are secure and have special 
purpose mechanisms for testing. 

Service descriptions must describe APIs in an automatically testable manner. These descriptions must 
specify method names, parameter names, and parameter types so that services can be bound at run-time. 
Service descriptions must also provide executable API test suites so that taxonomy servers can determine 
whether the service implements what it claims to implement before registering it in a given category. If 
the service implements exactly the API specified in the category's canonical service description, the 
service description need not provide any further tests. However any additional services must be 
accompanied by additional tests. 

The same set of executable test cases can be used to compare the performance of two eBusiness services 
that both implement the same category. For example, Service A and Service B are both in the same 
category. A requestor (perhaps in the form of a Quality of Service crawler) can execute the test cases 
against service A and compare the timing/cost/reliability against the same set of tests executed on service 
B. That way, a relative ordering of Service A and Service B, with respect to performance/cost/reliability 
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can be determined. 

3. If the same advantage or problem has been identified by others (inside/outside IBM), how have those 
others solved it and does your solution differ and why is it better? 

No other service-based or service oriented architecture that we have come across addresses the notion of 
categorization, let alone associate it with a canonical service description. 

4. If the invention is implemented in a product or prototype, include technical details, purpose, disclosure 
details to others and the date of that implementation. 

This item is explained with great depth in the "Tao of eBusiness Services" by Steve Burbeck. Further 
information about the Service Oriented Architectures project is available from any of the co-inventors. 



